home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-ietf-dns-resolver-mib-00.txt < prev    next >
Text File  |  1993-06-16  |  59KB  |  2,006 lines
  1.  
  2.  
  3.  
  4.           draft                  DNS Resolver MIB                June 93
  5.  
  6.  
  7.                            DNS Resolver MIB Extensions
  8.  
  9.                                    10-June-1993
  10.  
  11.  
  12.                                 DNS Working Group
  13.  
  14.                                    Rob Austein
  15.                          Epilogue Technology Corporation
  16.                                  sra@epilogue.com
  17.  
  18.  
  19.                                    Jon Saperia
  20.                           Digital Equipment Corporation
  21.                                saperia@tay.dec.com
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                                Status of this Memo
  28.  
  29.  
  30.           This document is an Internet Draft.  Internet Drafts are
  31.           working documents of the Internet Engineering Task Force
  32.           (IETF), its Areas, and its Working Groups.  Note that other
  33.           groups may also distribute working documents as Internet
  34.           Drafts.
  35.  
  36.           Internet Drafts are valid for a maximum of six months and may
  37.           be updated, replaced, or obsoleted by other documents at any
  38.           time.  It is inappropriate to use Internet Drafts as reference
  39.           material or to cite them other than as a "work in progress".
  40.  
  41.           Please check the id-abstracts.txt listing contained in the
  42.           internet-drafts Shadow Directories on the nic.ddn.mil,
  43.           nnsc.nsf.net, nic.nordu.net, ftp.nisc.sri.com, or
  44.           munnari.oz.au to learn the current status of any Internet
  45.           Draft.
  46.  
  47.           This document will be submitted to the Internet Architecture
  48.           Board as a Proposed Standard.  This document defines and
  49.           experimental extension to the SNMP MIB.  Upon publication as a
  50.           Proposed Standard, a new MIB number will be assigned.  This is
  51.           a working document only, it should neither be cited nor quoted
  52.  
  53.  
  54.  
  55.  
  56.  
  57.           Expires December 10,1993                              [Page 1]
  58.  
  59.  
  60.  
  61.  
  62.  
  63.           draft                  DNS Resolver MIB                June 93
  64.  
  65.  
  66.           in a formal document.
  67.  
  68.           This document will expire before 10 December 1993.
  69.  
  70.           Distribution of this document is unlimited.
  71.  
  72.           Please send comments to the authors.
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.           Expires December 10,1993                              [Page 2]
  117.  
  118.  
  119.  
  120.  
  121.  
  122.           draft                  DNS Resolver MIB                June 93
  123.  
  124.  
  125.           1.  Introduction
  126.  
  127.           This memo defines a set of extensions that have been created
  128.           for the Internet MIB which instrument DNS Resolver Functions
  129.           and was produced by the DNS working group.  This memo does not
  130.           specify a standard for the Internet community.
  131.  
  132.           With the adoption of The Simple Network Management Protocol
  133.           (RFC 1157), the Management Information Base for network
  134.           management of TCP/IP-based internets (RFC 1213), and the
  135.           Structure of Management Information (RFC 1155) by the
  136.           Internet, and a large number of vendor implementations of
  137.           these standards in commercially available products, it became
  138.           possible to provide a higher level of effective network
  139.           management in TCP/IP-based internets than previously
  140.           available.  With the growth in the use of these standards, it
  141.           has become possible to consider the management of other
  142.           elements of the infrastructure beyond the basic TCP/IP
  143.           protocols.  A key element of the TCP/IP infrastructure is the
  144.           DNS.
  145.  
  146.           Up to this point there has been no mechanism to integrate the
  147.           management of the DNS with SNMP-based managers.  This memo
  148.           provides the mechanisms by which IP-based management stations
  149.           can effectively manage DNS resolver software in an integrated
  150.           fashion through the use of the standard Internet SMI, MIB and
  151.           Simple Network Management Protocol.
  152.  
  153.           New DNS MIB objects have been defined to be used in
  154.           conjunction with the Internet MIB to allow access and control
  155.           of the DNS resolver software via SNMP by the Internet
  156.           community.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.           Expires December 10,1993                              [Page 3]
  176.  
  177.  
  178.  
  179.  
  180.  
  181.           draft                  DNS Resolver MIB                June 93
  182.  
  183.  
  184.           2.  The Network Management Framework
  185.  
  186.           The Internet-standard Network Management Framework consists of
  187.           four components.  They are:
  188.  
  189.           o    RFC 1155 which defines the SMI, the mechanisms used for
  190.                describing and naming objects for the purpose of
  191.                management.  RFC 1212 defines a more concise description
  192.                mechanism, which is wholly consistent with the SMI.
  193.  
  194.           o    RFC 1213 defines MIB-II, the core set of managed objects
  195.                for the Internet suite of protocols.
  196.  
  197.           o    RFC 1157 which defines the SNMP, the protocol used for
  198.                network access to managed objects.
  199.  
  200.           The Framework permits new objects to be defined for the
  201.           purpose of experimentation and evaluation.
  202.  
  203.  
  204.           2.1.  Object Definitions
  205.  
  206.           Managed objects are accessed via a virtual information store,
  207.           termed the Management Information Base or MIB.  Objects in the
  208.           MIB are defined using the subset of Abstract Syntax Notation
  209.           One (ASN.1) defined in the SMI.  In particular, each object
  210.           object type is named by an OBJECT IDENTIFIER, an
  211.           administratively assigned name.  The object type together with
  212.           an object instance serves to uniquely identify a specific
  213.           instantiation of the object.  For human convenience, we often
  214.           use a textual string, termed the descriptor, to refer to the
  215.           object type.
  216.  
  217.  
  218.           2.2.  Format of Definitions
  219.  
  220.           Section 5 contains the specification of all object types
  221.           contained in this MIB module.  The object types are defined
  222.           using the conventions defined in the SMI, as amended by the
  223.           extensions specified in [5,6].
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.           Expires December 10,1993                              [Page 4]
  235.  
  236.  
  237.  
  238.  
  239.  
  240.           draft                  DNS Resolver MIB                June 93
  241.  
  242.  
  243.           3.  Overview
  244.  
  245.           In theory, the DNS world is pretty simple.  There are two
  246.           kinds of entities: resolvers and name servers.  Resolvers ask
  247.           questions.  Name servers answer them.  The real world,
  248.           however, is not so simple.  Implementors have made widely
  249.           differing choices about how to divide DNS functions between
  250.           resolvers and servers.  They have also constructed various
  251.           sorts of exotic hybrids.  The most difficult task in defining
  252.           this MIB was to accommodate this wide range of entities
  253.           without having to come up with a separate MIB for each.
  254.  
  255.           We divided up the various DNS functions into two, non-
  256.           overlapping classes, called 'resolver functions' and 'name
  257.           server functions'.  A DNS entity that performs what we define
  258.           as resolver functions contains a resolver, and therefore must
  259.           implement the MIB groups required of all resolvers which are
  260.           defined in this module.  Some resolvers also implement
  261.           'optional' functions such as a cache.  In this example, they
  262.           will also implement the cache group contained in this MIB.  A
  263.           DNS entity which implements name server functions is
  264.           considered to be a name server, and must implement the MIB
  265.           groups required for name servers which are defined in a
  266.           separate module.  If the same piece of software performs both
  267.           resolver and server functions, we imagine that it contains
  268.           both a resolver and a server and would thus implement both the
  269.           DNS Server and DNS Resolver MIBs.
  270.  
  271.           In our model, a resolver is a program (or piece thereof) which
  272.           obtains resource records from servers.  Normally it does so at
  273.           the behest of an application, but may also do so as part of
  274.           its own operation.  A resolver sends DNS protocol queries and
  275.           receives DNS protocol replies.  A resolver neither receives
  276.           queries nor sends replies.  A full service resolver is one
  277.           that knows how to resolve queries: it obtains the needed
  278.           resource records by contacting a server authoritative for the
  279.           records desired.  A stub resolver does not know how to resolve
  280.           queries: it sends all queries to a local name server, setting
  281.           the recursion desired flag to indicate that it hopes that the
  282.           name server will be willing resolve the query.  A resolver may
  283.           (optionally) have a cache for remembering previously acquired
  284.           resource records.  It may also have a negative cache for
  285.           remembering names or data that have been determined not to
  286.           exist.
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.           Expires December 10,1993                              [Page 5]
  294.  
  295.  
  296.  
  297.  
  298.  
  299.           draft                  DNS Resolver MIB                June 93
  300.  
  301.  
  302.           A name server is a program (or piece thereof) that provides
  303.           resource records to resolvers.  All references in this
  304.           document to 'a name server' imply 'the name server's role'.
  305.           (In some cases the name server's role and the resolver's role
  306.           might be combined into a single program.)  A name server
  307.           receives DNS protocol queries and sends DNS protocol replies.
  308.           A name server neither sends queries nor receives replies. As a
  309.           consequence, name servers do not have caches.  Normally, a
  310.           name server would expect to receive only those queries to
  311.           which it could respond with authoritative information.
  312.           However, if a name server receives a query that it cannot
  313.           respond to with purely authoritative information, it may
  314.           choose to try to obtain the necessary additional information
  315.           from a resolver which may or may not be a separate process.
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.           Expires December 10,1993                              [Page 6]
  353.  
  354.  
  355.  
  356.  
  357.  
  358.           draft                  DNS Resolver MIB                June 93
  359.  
  360.  
  361.           4.  Selected Objects
  362.  
  363.           Many of the objects included in this memo have been created
  364.           from information contained in the DNS specification.  The DNS
  365.           specification is found in Domain Names - Concepts and
  366.           Facilities (RFC 1034) and Domain Names - Implementation and
  367.           Specification (RFC 1035), as amended and clarified by
  368.           Requirements for Internet Hosts - Application and Support
  369.           (RFC1123).  Additional usage information is found in the
  370.           Domain Administrators Guide (RFC 1032), and the Domain
  371.           Administrators Operations Guide (RFC 1033).  Other objects
  372.           have been created based on experience with existing DNS
  373.           management tools, expected operational need, and the
  374.           statistics generated by existing DNS implementations.  These
  375.           objects have been ordered into groups as follows:
  376.  
  377.               Resolver Configuration Group
  378.               Resolver Counter Group
  379.               Resolver Cache Group
  380.               Resolver Negative Cache Group
  381.               Resolver Statistics Group
  382.               Resolver Optional Counter Group
  383.  
  384.           Some of the objects defined in this memo have been created
  385.           from information contained in existing configuration files
  386.           used by many DNS implementations. This information has been
  387.           converted into a standard form using the Internet Standard SMI
  388.           defined in RFC 1155.  The object descriptors used in this MIB
  389.           have been created from a variety of sources.  For the most
  390.           part, the descriptions are influenced by by the DNS related
  391.           RFCs noted above.  For example, the descriptors for counters
  392.           used for the various types of queries of DNS records are
  393.           influenced by the definitions used for the various record
  394.           types found in Domain Names - Implementation and Specification
  395.           RFC 1035.
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.           Expires December 10,1993                              [Page 7]
  412.  
  413.  
  414.  
  415.  
  416.  
  417.           draft                  DNS Resolver MIB                June 93
  418.  
  419.  
  420.           5.  Textual Conventions
  421.  
  422.           Several datatypes have been introduced as a textual
  423.           conventions in the DNS Server MIB document and have been
  424.           imported into this MIB Module.  These additions will
  425.           facilitate the common understanding of information used by the
  426.           DNS.  No changes to the SMI or the SNMP are necessary to
  427.           support these conventions which are described in the
  428.           Definitions section.
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.           Expires December 10,1993                              [Page 8]
  471.  
  472.  
  473.  
  474.  
  475.  
  476.           draft                  DNS Resolver MIB                June 93
  477.  
  478.  
  479.           6.  Definitions
  480.  
  481.                RFCxxxx-dnsResMIB
  482.  
  483.                DEFINITIONS ::= BEGIN
  484.  
  485.                IMPORTS
  486.                    IpAddress, Counter,
  487.                    experimental
  488.                      FROM RFC1155-SMI
  489.                    DisplayString
  490.                      FROM RFC1213-MIB
  491.                    OBJECT-TYPE
  492.                      FROM RFC-1212
  493.                    dns, DnsDate, DnsName, DnsClass,
  494.                    DnsType, DnsQClass, DnsQType, DnsTime,
  495.                    DnsValid, DnsOpCode, DnsRespCode
  496.                      FROM RFC-xxxx;
  497.  
  498.           -- DNS Resolver MIB
  499.  
  500.                dnsRes          OBJECT IDENTIFIER ::= { dns 2 }
  501.  
  502.           -- groups in the dns resolver mib
  503.  
  504.                 dnsResConfig                  OBJECT IDENTIFIER ::= { dnsRes 1 }
  505.                 dnsResCounter                 OBJECT IDENTIFIER ::= { dnsRes 2 }
  506.                 dnsResCache                   OBJECT IDENTIFIER ::= { dnsRes 3 }
  507.                 dnsResNCache                  OBJECT IDENTIFIER ::= { dnsRes 4 }
  508.                 dnsResStats                   OBJECT IDENTIFIER ::= { dnsRes 5 }
  509.                 dnsResOptCounter              OBJECT IDENTIFIER ::= { dnsRes 6 }
  510.  
  511.           -- Resolver Configuration Group
  512.  
  513.           -- The implementation of the Resolver Configuration group is
  514.           -- mandatory for all systems which implement any resolver software
  515.           -- functions.
  516.  
  517.           dnsResConfigImplementIdent OBJECT-TYPE
  518.                SYNTAX  DisplayString
  519.                ACCESS  read-only
  520.                STATUS  mandatory
  521.                DESCRIPTION
  522.                        "The implementation identification string for the resolver
  523.                        software in use on the system, for example; RES2.1"
  524.  
  525.  
  526.  
  527.  
  528.  
  529.           Expires December 10,1993                              [Page 9]
  530.  
  531.  
  532.  
  533.  
  534.  
  535.           draft                  DNS Resolver MIB                June 93
  536.  
  537.  
  538.                ::= { dnsResConfig 1 }
  539.  
  540.           dnsResConfigService OBJECT-TYPE
  541.                SYNTAX  INTEGER {
  542.                     recursive-only (1),
  543.                     iterative-only (2),
  544.                     recursive-and-iterative (3)
  545.                }
  546.                ACCESS  read-only
  547.                STATUS  mandatory
  548.                DESCRIPTION
  549.                     "Kind of DNS resolution service provided.
  550.                     RECURSIVE-ONLY indicates a stub resolver.
  551.  
  552.                     ITERATIVE-ONLY indicates a normal full service resolver.
  553.  
  554.                     RECURSIVE-AND-ITERATIVE indicates a full service resolver
  555.                     which performs a mix of recursive and iterative queries."
  556.                ::= { dnsResConfig 2 }
  557.  
  558.           dnsResConfigMaxCnames OBJECT-TYPE
  559.                SYNTAX  INTEGER
  560.                ACCESS  read-write
  561.                STATUS  mandatory
  562.                DESCRIPTION
  563.                     "Limit on how many CNAMEs the resolver should allow before
  564.                     deciding that there's a CNAME loop.  Zero means that
  565.                     resolver has no explicit CNAME limit.  See RFC 1035 section
  566.                     7.1 for more information on circular CNAME references."
  567.                ::= { dnsResConfig 3 }
  568.  
  569.           -- DNS Resolver Seat Belt Table
  570.  
  571.           dnsResConfigSeatBeltTable OBJECT-TYPE
  572.                SYNTAX  SEQUENCE OF DnsResConfigSeatBeltEntry
  573.                ACCESS  not-accessible
  574.                STATUS  mandatory
  575.                DESCRIPTION
  576.                     "Table of safety belt information used by the resolver
  577.                     when it hasn't got any better idea of where to send a
  578.                     query, such as when the resolver is booting or is a stub
  579.                     resolver."
  580.                ::= { dnsResConfig 4 }
  581.  
  582.           dnsResConfigSeatBeltEntry OBJECT-TYPE
  583.  
  584.  
  585.  
  586.  
  587.  
  588.           Expires December 10,1993                             [Page 10]
  589.  
  590.  
  591.  
  592.  
  593.  
  594.           draft                  DNS Resolver MIB                June 93
  595.  
  596.  
  597.                SYNTAX  DnsResConfigSeatBeltEntry
  598.                ACCESS  not-accessible
  599.                STATUS  mandatory
  600.                DESCRIPTION
  601.                        "An entry in the resolver's seatbelt table."
  602.                INDEX { dnsResConfigSeatBeltAddr,
  603.                        dnsResConfigSeatBeltSubTree,
  604.                        dnsResConfigSeatBeltClass }
  605.                ::= { dnsResConfigSeatBeltTable 1 }
  606.  
  607.           DnsResConfigSeatBeltEntry ::=
  608.                SEQUENCE {
  609.                   dnsResConfigSeatBeltAddr
  610.                       IpAddress,
  611.                   dnsResConfigSeatBeltName
  612.                       DnsName,
  613.                   dnsResConfigSeatBeltRecursion
  614.                       INTEGER,
  615.                   dnsResConfigSeatBeltPref
  616.                       INTEGER,
  617.                   dnsResConfigSeatBeltSubTree
  618.                       DnsName,
  619.                   dnsResConfigSeatBeltClass
  620.                       DnsClass,
  621.                   dnsResConfigSeatBeltFile
  622.                       OCTET STRING,
  623.                   dnsResConfigSeatBeltDate
  624.                       DnsDate,
  625.                   dnsResConfigSeatBeltValid
  626.                       DnsValid
  627.                }
  628.           dnsResConfigSeatBeltAddr OBJECT-TYPE
  629.                SYNTAX  IpAddress
  630.                ACCESS  read-only
  631.                STATUS  mandatory
  632.                DESCRIPTION
  633.                        "The IP address of the SeatBelt name server identified
  634.                        by this row of the table."
  635.                ::= { dnsResConfigSeatBeltEntry 1 }
  636.  
  637.           dnsResConfigSeatBeltName OBJECT-TYPE
  638.                SYNTAX  DnsName  --  OCTET STRING
  639.                ACCESS  read-only
  640.                STATUS  mandatory
  641.                DESCRIPTION
  642.  
  643.  
  644.  
  645.  
  646.  
  647.           Expires December 10,1993                             [Page 11]
  648.  
  649.  
  650.  
  651.  
  652.  
  653.           draft                  DNS Resolver MIB                June 93
  654.  
  655.  
  656.                        "The DNS name of a SeatBelt nameserver identified by this
  657.                        row of the table.  A value of NULL indicates that the name
  658.                        is not known by the resolver."
  659.                ::= { dnsResConfigSeatBeltEntry 2 }
  660.  
  661.           dnsResConfigSeatBeltRecursion OBJECT-TYPE
  662.                SYNTAX  INTEGER {
  663.                     iterative (1),
  664.                     recursive (2),
  665.                     recursive-and-iterative (3)
  666.                }
  667.                ACCESS  read-only
  668.                STATUS  mandatory
  669.                DESCRIPTION
  670.                        "Kind of queries resolver will be sending to the server.
  671.  
  672.                        ITERATIVE indicates that resolver will be directing
  673.                        iterative queries to this name server (RD bit turned
  674.                        off).
  675.  
  676.                        RECURSIVE indicates that resolver will be directing
  677.                        recursive queries to this name server (RD bit turned
  678.                        on).
  679.  
  680.                        RECURSIVE-AND-ITERATIVE indicates that the resolver will
  681.                        be directing both recursive and iterative queries to the
  682.                        server identified in this row of the table."
  683.                ::= { dnsResConfigSeatBeltEntry 3 }
  684.  
  685.           dnsResConfigSeatBeltPref OBJECT-TYPE
  686.                SYNTAX  INTEGER
  687.                ACCESS  read-only
  688.                STATUS  mandatory
  689.                DESCRIPTION
  690.                        "This value identifies the preference for the server
  691.                        identified in this row of the table.  The lower the
  692.                        value, the more desirable the particular server is
  693.                        considered."
  694.                ::= { dnsResConfigSeatBeltEntry 4 }
  695.  
  696.           dnsResConfigSeatBeltSubTree OBJECT-TYPE
  697.                SYNTAX  DnsName  --  OCTET STRING
  698.                ACCESS  read-only
  699.                STATUS  mandatory
  700.                DESCRIPTION
  701.  
  702.  
  703.  
  704.  
  705.  
  706.           Expires December 10,1993                             [Page 12]
  707.  
  708.  
  709.  
  710.  
  711.  
  712.           draft                  DNS Resolver MIB                June 93
  713.  
  714.  
  715.                        "Queries sent to the Seatbelt name server identified by
  716.                         this row of the table are limited to those for names
  717.                         in the name subtree identified by this variable.  If no
  718.                         such limitation applies, the value of this variable is
  719.                         the name of THE root domain."
  720.                ::= { dnsResConfigSeatBeltEntry 5 }
  721.  
  722.           dnsResConfigSeatBeltClass OBJECT-TYPE
  723.                SYNTAX  DnsClass -- INTEGER (0..65535)
  724.                ACCESS  read-only
  725.                STATUS  mandatory
  726.                DESCRIPTION
  727.                        "The class of DNS queries that will be sent to the
  728.                        server identified by this row of the table."
  729.                ::= { dnsResConfigSeatBeltEntry 6 }
  730.  
  731.           dnsResConfigSeatBeltFile OBJECT-TYPE
  732.                SYNTAX  OCTET STRING
  733.                ACCESS  read-only
  734.                STATUS  mandatory
  735.                DESCRIPTION
  736.                        "The name of the file from which the information in
  737.                        this row of the table was last initialized or updated.
  738.                        The value is the null string if information came from a
  739.                        source other than a configuration file."
  740.                ::= { dnsResConfigSeatBeltEntry 7 }
  741.  
  742.           dnsResConfigSeatBeltDate OBJECT-TYPE
  743.                SYNTAX  DnsDate -- DisplayString
  744.                ACCESS  read-only
  745.                STATUS  mandatory
  746.                DESCRIPTION
  747.                        "The date and time that the file named by the
  748.                        dnsResConfigSeatBeltFile variable for this row had last
  749.                        been updated at the time that this row was last initialized
  750.                        or updated.  The value is the null string if unknown or not
  751.                        applicable because the dnsResConfigSeatBeltFile variable is
  752.                        a null string."
  753.                ::= { dnsResConfigSeatBeltEntry 8 }
  754.  
  755.           dnsResConfigSeatBeltValid OBJECT-TYPE
  756.                SYNTAX  DnsValid
  757.                ACCESS  read-write
  758.                STATUS  mandatory
  759.                DESCRIPTION
  760.  
  761.  
  762.  
  763.  
  764.  
  765.           Expires December 10,1993                             [Page 13]
  766.  
  767.  
  768.  
  769.  
  770.  
  771.           draft                  DNS Resolver MIB                June 93
  772.  
  773.  
  774.                        "Setting this variable to CLEAR deletes this SeatBelt
  775.                        server."
  776.                ::= { dnsResConfigSeatBeltEntry 9 }
  777.  
  778.           -- Resolver Counters Group
  779.  
  780.           -- The implementation of the Resolver Counters Group is mandatory for
  781.           -- all systems which implement resolver functions
  782.  
  783.           dnsResCounterUpTime OBJECT-TYPE
  784.                SYNTAX  DnsTime
  785.                ACCESS  read-only
  786.                STATUS  mandatory
  787.                DESCRIPTION
  788.                        "If the resolver has a persistent state, e.g., a
  789.                        process; this value will be the time elapsed since it
  790.                        started.  For software that does not have persistence,
  791.                        this value will be 0."
  792.               ::= { dnsResCounter 1 }
  793.  
  794.           dnsResCounterResetTime OBJECT-TYPE
  795.                SYNTAX  DnsTime
  796.                ACCESS  read-only
  797.                STATUS  mandatory
  798.                DESCRIPTION
  799.                        "Elapsed time since cache was reloaded."
  800.               ::= { dnsResCounter 2 }
  801.  
  802.           -- Resolver Counter Table
  803.  
  804.           dnsResCounterTable OBJECT-TYPE
  805.                SYNTAX  SEQUENCE OF DnsResCounterTableEntry
  806.                ACCESS  not-accessible
  807.                STATUS  mandatory
  808.                DESCRIPTION
  809.                        "Table of the current count of resolver queries and
  810.                        answers."
  811.               ::= { dnsResCounter 3 }
  812.  
  813.           dnsResCounterTableEntry OBJECT-TYPE
  814.                SYNTAX  DnsResCounterTableEntry
  815.                ACCESS  not-accessible
  816.                STATUS  mandatory
  817.                DESCRIPTION
  818.                        "Entry in the resolver counter table.  Entries are
  819.  
  820.  
  821.  
  822.  
  823.  
  824.           Expires December 10,1993                             [Page 14]
  825.  
  826.  
  827.  
  828.  
  829.  
  830.           draft                  DNS Resolver MIB                June 93
  831.  
  832.  
  833.                        indexed by dns OpCode."
  834.                INDEX { dnsResCounterOpCode }
  835.                ::= { dnsResCounterTable 1 }
  836.  
  837.           DnsResCounterTableEntry ::=
  838.                SEQUENCE {
  839.                    dnsResCounterOpCode
  840.                         DnsOpCode,
  841.                    dnsResCounterQueries
  842.                         Counter,
  843.                    dnsResCounterResponses
  844.                         Counter
  845.                }
  846.           dnsResCounterOpCode OBJECT-TYPE
  847.                SYNTAX  DnsOpCode -- INTEGER (0..15)
  848.                ACCESS  read-only
  849.                STATUS  mandatory
  850.                DESCRIPTION
  851.                        "The index to this table.  The OpCodes that have
  852.                        already been defined are found in RFC1035."
  853.                ::= { dnsResCounterTableEntry 1 }
  854.  
  855.           dnsResCounterQueries OBJECT-TYPE
  856.                SYNTAX  Counter
  857.                ACCESS  read-only
  858.                STATUS  mandatory
  859.                DESCRIPTION
  860.                        "Number of queries [total] that have sent out by the
  861.                        resolver since initialization for the OpCode which is
  862.                        the index to this row of the table."
  863.                ::= { dnsResCounterTableEntry 2 }
  864.  
  865.           dnsResCounterResponses OBJECT-TYPE
  866.                SYNTAX  Counter
  867.                ACCESS  read-only
  868.                STATUS  mandatory
  869.                DESCRIPTION
  870.                        "Number of responses [total] that have been received
  871.                        by the resolver since initialization for the OpCode
  872.                        which is the index to this row of the table."
  873.                ::= { dnsResCounterTableEntry 3 }
  874.  
  875.           -- Resolver Response Code Counter Table
  876.  
  877.           dnsResResponseTable OBJECT-TYPE
  878.  
  879.  
  880.  
  881.  
  882.  
  883.           Expires December 10,1993                             [Page 15]
  884.  
  885.  
  886.  
  887.  
  888.  
  889.           draft                  DNS Resolver MIB                June 93
  890.  
  891.  
  892.                SYNTAX  SEQUENCE OF DnsResResponseTableEntry
  893.                ACCESS  not-accessible
  894.                STATUS  mandatory
  895.                DESCRIPTION
  896.                        "Table of the current count of responses to resolver
  897.                        queries."
  898.               ::= { dnsResCounter 4 }
  899.  
  900.           dnsResResponseTableEntry OBJECT-TYPE
  901.                SYNTAX  DnsResResponseTableEntry
  902.                ACCESS  not-accessible
  903.                STATUS  mandatory
  904.                DESCRIPTION
  905.                        "Entry in the resolver response table.  Entries are
  906.                        indexed by DNS response code."
  907.                INDEX { dnsResResponseCode }
  908.                ::= { dnsResResponseTable 1 }
  909.  
  910.           DnsResResponseTableEntry ::=
  911.                SEQUENCE {
  912.                    dnsResResponseCode
  913.                         DnsRespCode,
  914.                    dnsResResponses
  915.                         Counter
  916.                }
  917.           dnsResResponseCode OBJECT-TYPE
  918.                SYNTAX  DnsRespCode -- INTEGER (0..15)
  919.                ACCESS  read-only
  920.                STATUS  mandatory
  921.                DESCRIPTION
  922.                        "The index to this table.  The Response Codes that have
  923.                        already been defined are found in RFC1035."
  924.                ::= { dnsResResponseTableEntry 1 }
  925.  
  926.           dnsResResponses OBJECT-TYPE
  927.                SYNTAX  Counter
  928.                ACCESS  read-only
  929.                STATUS  mandatory
  930.                DESCRIPTION
  931.                        "Number of responses the resolver has received for the
  932.                        response code value which identifies this row of the
  933.                        table."
  934.                ::= { dnsResResponseTableEntry 2 }
  935.  
  936.           -- Additional DNS Resolver Counter Objects
  937.  
  938.  
  939.  
  940.  
  941.  
  942.           Expires December 10,1993                             [Page 16]
  943.  
  944.  
  945.  
  946.  
  947.  
  948.           draft                  DNS Resolver MIB                June 93
  949.  
  950.  
  951.           dnsResCounterNonAuthDataResps OBJECT-TYPE
  952.                SYNTAX  Counter
  953.                ACCESS  read-only
  954.                STATUS  mandatory
  955.                DESCRIPTION
  956.                        "Number of requests made by the resolver for which a
  957.                        non-authoritative answer (cached data) was received."
  958.                ::= { dnsResCounter 5 }
  959.  
  960.           dnsResCounterNonAuthNoDataResps OBJECT-TYPE
  961.                SYNTAX  Counter
  962.                ACCESS  read-only
  963.                STATUS  mandatory
  964.                DESCRIPTION
  965.                        "Number of requests made by the resolver for which a
  966.                        non-authoritative answer - no such data response
  967.                        (empty answer) was received."
  968.                ::= { dnsResCounter 6 }
  969.  
  970.           dnsResCounterMartians OBJECT-TYPE
  971.                SYNTAX  Counter
  972.                ACCESS  read-only
  973.                STATUS  mandatory
  974.                DESCRIPTION
  975.                        "Number of responses received which were received from
  976.                        servers that the resolver does not think it asked."
  977.                ::= { dnsResCounter 7 }
  978.  
  979.           dnsResCounterRecdResponses OBJECT-TYPE
  980.                SYNTAX  Counter
  981.                ACCESS  read-only
  982.                STATUS  mandatory
  983.                DESCRIPTION
  984.                        "Number of responses received to all queries."
  985.                ::= { dnsResCounter 8 }
  986.  
  987.           dnsResCounterUnparseResps OBJECT-TYPE
  988.                SYNTAX  Counter
  989.                ACCESS  read-only
  990.                STATUS  mandatory
  991.                DESCRIPTION
  992.                        "Number of responses received which were unparseable."
  993.                ::= { dnsResCounter 9 }
  994.  
  995.           dnsResCounterFallbacks OBJECT-TYPE
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.           Expires December 10,1993                             [Page 17]
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.           draft                  DNS Resolver MIB                June 93
  1008.  
  1009.  
  1010.                SYNTAX  Counter
  1011.                ACCESS  read-only
  1012.                STATUS  mandatory
  1013.                DESCRIPTION
  1014.                        "Number of times the resolver had to fall back to its seat
  1015.                        belt information."
  1016.                ::= { dnsResCounter 10 }
  1017.  
  1018.           -- Resolver Cache Group
  1019.  
  1020.           -- The implementation of the Resolver Cache Group is mandatory for
  1021.           -- all systems which implement a cache.
  1022.  
  1023.           dnsResCacheStatus OBJECT-TYPE
  1024.                SYNTAX  INTEGER {
  1025.                     enabled (1),
  1026.                     disabled (2)
  1027.                }
  1028.                ACCESS  read-only
  1029.                STATUS  mandatory
  1030.                DESCRIPTION
  1031.                        "Status of the resolver's cache.
  1032.                        ENABLED means that the use of the cache is allowed.
  1033.  
  1034.                        DISABLED means that the cache is not being used."
  1035.                ::= { dnsResCache 1 }
  1036.  
  1037.           dnsResCacheValid OBJECT-TYPE
  1038.                SYNTAX  DnsValid
  1039.                ACCESS  read-write
  1040.                STATUS  mandatory
  1041.                DESCRIPTION
  1042.                        "Setting this to CLEAR deletes the resolver's entire
  1043.                        cache."
  1044.                ::= { dnsResCache 2 }
  1045.  
  1046.           dnsResCacheMaxTTL OBJECT-TYPE
  1047.                SYNTAX  DnsTime
  1048.                ACCESS  read-write
  1049.                STATUS  mandatory
  1050.                DESCRIPTION
  1051.                        "Maximum Time-To-Live for RRs in this cache.  If the
  1052.                        resolver does not implement a TTL ceiling, the value of
  1053.                        this field should be hexadecimal FFFFFFFF."
  1054.                ::= { dnsResCache 3 }
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.           Expires December 10,1993                             [Page 18]
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.           draft                  DNS Resolver MIB                June 93
  1067.  
  1068.  
  1069.           -- Resolver Cache Table
  1070.  
  1071.           -- The Resolver Cache Table contains information about Resource
  1072.           -- Records currently in the resolver's cache.
  1073.  
  1074.           dnsResCacheTable OBJECT-TYPE
  1075.                SYNTAX  SEQUENCE OF DnsResCacheEntry
  1076.                ACCESS  not-accessible
  1077.                STATUS  mandatory
  1078.                DESCRIPTION
  1079.                        "The entire contents of the resolver's cache."
  1080.               ::= { dnsResCache 4 }
  1081.  
  1082.           dnsResCacheEntry OBJECT-TYPE
  1083.                SYNTAX  DnsResCacheEntry
  1084.                ACCESS  not-accessible
  1085.                STATUS  mandatory
  1086.                DESCRIPTION
  1087.                        "A single entry in the resolvers's cache."
  1088.                INDEX { dnsResCacheName, dnsResCacheClass,
  1089.                        dnsResCacheType, dnsResCacheIndex  }
  1090.                ::= { dnsResCacheTable 1 }
  1091.  
  1092.           DnsResCacheEntry ::=
  1093.                SEQUENCE {
  1094.                    dnsResCacheName
  1095.                        DnsName,
  1096.                    dnsResCacheClass
  1097.                        DnsClass,
  1098.                    dnsResCacheType
  1099.                        DnsType,
  1100.                    dnsResCacheTTL
  1101.                        DnsTime,
  1102.                    dnsResCacheElapsedTTL
  1103.                        DnsTime,
  1104.                    dnsResCacheSource
  1105.                        IpAddress,
  1106.                    dnsResCacheRData
  1107.                        OCTET STRING,
  1108.                    dnsResCacheEntryValid
  1109.                        DnsValid,
  1110.                    dnsResCacheIndex
  1111.                        INTEGER
  1112.                }
  1113.           dnsResCacheName OBJECT-TYPE
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.           Expires December 10,1993                             [Page 19]
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.           draft                  DNS Resolver MIB                June 93
  1126.  
  1127.  
  1128.                SYNTAX  DnsName  --  OCTET STRING
  1129.                ACCESS  read-only
  1130.                STATUS  mandatory
  1131.                DESCRIPTION
  1132.                        "Owner name of the Resource Record in the cache which
  1133.                        is identified in this row of the table.  As described
  1134.                        in RFC1034, the owner of the record is the domain name
  1135.                        were the RR is found."
  1136.                ::= { dnsResCacheEntry 1 }
  1137.  
  1138.           dnsResCacheClass OBJECT-TYPE
  1139.                SYNTAX  DnsClass -- INTEGER (0..65535)
  1140.                ACCESS  read-only
  1141.                STATUS  mandatory
  1142.                DESCRIPTION
  1143.                        "DNS class of the Resource Record in the cache which
  1144.                        is identified in this row of the table."
  1145.                ::= { dnsResCacheEntry 2 }
  1146.  
  1147.           dnsResCacheType OBJECT-TYPE
  1148.                SYNTAX  DnsType -- INTEGER (0..65535)
  1149.                ACCESS  read-only
  1150.                STATUS  mandatory
  1151.                DESCRIPTION
  1152.                        "DNS type of the Resource Record in the cache which
  1153.                        is identified in this row of the table."
  1154.                ::= { dnsResCacheEntry 3 }
  1155.  
  1156.           dnsResCacheTTL OBJECT-TYPE
  1157.                SYNTAX  DnsTime
  1158.                ACCESS  read-only
  1159.                STATUS  mandatory
  1160.                DESCRIPTION
  1161.                        "Time-To-Live of RR in DNS cache.  This is the initial
  1162.                        TTL value which was received with the RR when it was
  1163.                        originally received."
  1164.                ::= { dnsResCacheEntry 4 }
  1165.  
  1166.           dnsResCacheElapsedTTL OBJECT-TYPE
  1167.                SYNTAX  DnsTime
  1168.                ACCESS  read-only
  1169.                STATUS  mandatory
  1170.                DESCRIPTION
  1171.                        "Elapsed seconds since RR was received."
  1172.                ::= { dnsResCacheEntry 5 }
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.           Expires December 10,1993                             [Page 20]
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.           draft                  DNS Resolver MIB                June 93
  1185.  
  1186.  
  1187.           dnsResCacheSource OBJECT-TYPE
  1188.                SYNTAX  IpAddress
  1189.                ACCESS  read-only
  1190.                STATUS  mandatory
  1191.                DESCRIPTION
  1192.                        "Host from which RR was received, 0.0.0.0 if unknown."
  1193.                ::= { dnsResCacheEntry 6 }
  1194.  
  1195.           dnsResCacheRData OBJECT-TYPE
  1196.                SYNTAX  OCTET STRING
  1197.                ACCESS  read-only
  1198.                STATUS  mandatory
  1199.                DESCRIPTION
  1200.                        "RDATA portion of a cached RR."
  1201.                ::= { dnsResCacheEntry 7 }
  1202.  
  1203.           dnsResCacheEntryValid OBJECT-TYPE
  1204.                SYNTAX  DnsValid
  1205.                ACCESS  read-write
  1206.                STATUS  mandatory
  1207.                DESCRIPTION
  1208.                        "Set to CLEAR to delete this RR entry from the
  1209.                        cache table."
  1210.                ::= { dnsResCacheEntry 8 }
  1211.  
  1212.           dnsResCacheIndex OBJECT-TYPE
  1213.                SYNTAX  INTEGER
  1214.                ACCESS  read-only
  1215.                STATUS  mandatory
  1216.                DESCRIPTION
  1217.                        "A value which makes entries in the table unqiue when the
  1218.                        other index values - dnsResCacheName, dnsResCacheClass, and
  1219.                        dnsResCacheType do not provide uniqueness."
  1220.                ::= { dnsResCacheEntry 9 }
  1221.  
  1222.           -- Resolver Negative Cache Group
  1223.  
  1224.           -- The implementation of the Resolver Negative Cache group is
  1225.           -- mandatory for all systems which implement negative a negative
  1226.           -- cache function.
  1227.  
  1228.           dnsResNCacheStatus OBJECT-TYPE
  1229.                SYNTAX  INTEGER {
  1230.                     enabled (1),
  1231.                     disabled (2)
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.           Expires December 10,1993                             [Page 21]
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.           draft                  DNS Resolver MIB                June 93
  1244.  
  1245.  
  1246.                }
  1247.                ACCESS  read-only
  1248.                STATUS  mandatory
  1249.                DESCRIPTION
  1250.                        "Status of the resolver's negative cache.
  1251.                        ENABLED means that the use of the negative cache is
  1252.                        allowed.
  1253.  
  1254.                        DISABLED means that the negative caching is not being
  1255.                        used."
  1256.                ::= { dnsResNCache 1 }
  1257.  
  1258.           dnsResNCacheValid OBJECT-TYPE
  1259.                SYNTAX  DnsValid
  1260.                ACCESS  read-write
  1261.                STATUS  mandatory
  1262.                DESCRIPTION
  1263.                        "Setting this to CLEAR deletes the resolver's entire
  1264.                        negative response cache."
  1265.                ::= { dnsResNCache 2 }
  1266.  
  1267.           dnsResNCacheMaxTTL OBJECT-TYPE
  1268.                SYNTAX  DnsTime
  1269.                ACCESS  read-write
  1270.                STATUS  mandatory
  1271.                DESCRIPTION
  1272.                        "Maximum Time-To-Live for cached authoritative errors.
  1273.                        If the resolver does not implement a TTL ceiling, the
  1274.                        value of this field should be hexadecimal FFFFFFFF."
  1275.                ::= { dnsResNCache 3 }
  1276.  
  1277.           -- Resolver Negative Cache Table
  1278.  
  1279.           -- The Resolver Negative Cache Table contains information about
  1280.           -- authoritative errors that have been cached by the resolver.
  1281.  
  1282.           dnsResNCacheTable OBJECT-TYPE
  1283.                SYNTAX  SEQUENCE OF DnsResNCacheEntry
  1284.                ACCESS  not-accessible
  1285.                STATUS  mandatory
  1286.                DESCRIPTION
  1287.                        "The resolver's negative response cache."
  1288.                ::= { dnsResNCache 4 }
  1289.  
  1290.           dnsResNCacheEntry OBJECT-TYPE
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.           Expires December 10,1993                             [Page 22]
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.           draft                  DNS Resolver MIB                June 93
  1303.  
  1304.  
  1305.                SYNTAX  DnsResNCacheEntry
  1306.                ACCESS  not-accessible
  1307.                STATUS  mandatory
  1308.                DESCRIPTION
  1309.                        "An entry in the resolver's negative response cache."
  1310.                INDEX { dnsResNCacheErrQName, dnsResNCacheErrQClass,
  1311.                        dnsResNCacheErrQType, dnsResNCacheIndex  }
  1312.                ::= { dnsResNCacheTable 1 }
  1313.  
  1314.           DnsResNCacheEntry ::=
  1315.                SEQUENCE {
  1316.                    dnsResNCacheErrQName
  1317.                        DnsName,
  1318.                    dnsResNCacheErrQClass
  1319.                        DnsQClass,
  1320.                    dnsResNCacheErrQType
  1321.                        DnsQType,
  1322.                    dnsResNCacheErrTTL
  1323.                        DnsTime,
  1324.                    dnsResNCacheErrElapsedTTL
  1325.                        DnsTime,
  1326.                    dnsResNCacheErrSource
  1327.                        IpAddress,
  1328.                    dnsResNCacheErrCode
  1329.                        INTEGER,
  1330.                    dnsResNCacheErrValid
  1331.                        DnsValid,
  1332.                    dnsResNCacheIndex
  1333.                        INTEGER
  1334.                }
  1335.           dnsResNCacheErrQName OBJECT-TYPE
  1336.                SYNTAX  DnsName  --  OCTET STRING
  1337.                ACCESS  read-only
  1338.                STATUS  mandatory
  1339.                DESCRIPTION
  1340.                        "QNAME associated with a cached authoritative error."
  1341.                ::= { dnsResNCacheEntry 1 }
  1342.  
  1343.           dnsResNCacheErrQClass OBJECT-TYPE
  1344.                SYNTAX  DnsQClass -- INTEGER (0..65535)
  1345.                ACCESS  read-only
  1346.                STATUS  mandatory
  1347.                DESCRIPTION
  1348.                       "DNS QCLASS associated with a cached authoritative error."
  1349.                ::= { dnsResNCacheEntry 2 }
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.           Expires December 10,1993                             [Page 23]
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.           draft                  DNS Resolver MIB                June 93
  1362.  
  1363.  
  1364.           dnsResNCacheErrQType OBJECT-TYPE
  1365.                SYNTAX  DnsQType -- INTEGER (0..65535)
  1366.                ACCESS  read-only
  1367.                STATUS  mandatory
  1368.                DESCRIPTION
  1369.                        "DNS QTYPE associated with a cached authoritative error."
  1370.                ::= { dnsResNCacheEntry 3 }
  1371.  
  1372.           dnsResNCacheErrTTL OBJECT-TYPE
  1373.                SYNTAX  DnsTime
  1374.                ACCESS  read-only
  1375.                STATUS  mandatory
  1376.                DESCRIPTION
  1377.                        "Time-To-Live of a cached authoritative error at the
  1378.                        time of the error, it should not be decremented
  1379.                        by the number of seconds since it was recieved. This
  1380.                        should be the TTL as copied from the MINIMUM field of
  1381.                        the SOA that accompanied the authoritative error."
  1382.                ::= { dnsResNCacheEntry 4 }
  1383.  
  1384.           dnsResNCacheErrElapsedTTL OBJECT-TYPE
  1385.                SYNTAX  DnsTime
  1386.                ACCESS  read-only
  1387.                STATUS  mandatory
  1388.                DESCRIPTION
  1389.                        "Elapsed seconds since authoritative error was received."
  1390.                ::= { dnsResNCacheEntry 5 }
  1391.  
  1392.           dnsResNCacheErrSource OBJECT-TYPE
  1393.                SYNTAX  IpAddress
  1394.                ACCESS  read-only
  1395.                STATUS  mandatory
  1396.                DESCRIPTION
  1397.                        "Host which sent the authoritative error, 0.0.0.0 if
  1398.                        unknown."
  1399.                ::= { dnsResNCacheEntry 6 }
  1400.  
  1401.           dnsResNCacheErrCode OBJECT-TYPE
  1402.                SYNTAX  INTEGER {
  1403.                    nonexistantName (1),
  1404.                    noData (2),
  1405.                    other (3)
  1406.                }
  1407.                ACCESS  read-only
  1408.                STATUS  mandatory
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.           Expires December 10,1993                             [Page 24]
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.           draft                  DNS Resolver MIB                June 93
  1421.  
  1422.  
  1423.                DESCRIPTION
  1424.                       "The authoritative error that has been cached.
  1425.                        NonexistantName indicates an authoritative name
  1426.                        error.  NoData indicates an authoritative
  1427.                        response with no error and no relevant data."
  1428.                ::= { dnsResNCacheEntry 7 }
  1429.  
  1430.           dnsResNCacheErrValid OBJECT-TYPE
  1431.                SYNTAX  DnsValid
  1432.                ACCESS  read-write
  1433.                STATUS  mandatory
  1434.                DESCRIPTION
  1435.                       "Set to CLEAR to delete this cached error."
  1436.                ::= { dnsResNCacheEntry 8 }
  1437.  
  1438.           dnsResNCacheIndex OBJECT-TYPE
  1439.                SYNTAX  INTEGER
  1440.                ACCESS  read-only
  1441.                STATUS  mandatory
  1442.                DESCRIPTION
  1443.                        "A value which makes entries in the table unique when the
  1444.                        other index values -  dnsResNCacheErrQName,
  1445.                        dnsResNCacheErrQClass, and dnsResNCacheErrQType do not
  1446.                        provide uniqueness."
  1447.                ::= { dnsResNCacheEntry 9 }
  1448.  
  1449.           -- Resolver Statistics Group
  1450.  
  1451.           -- The implementation of the Resolver Statistics Group is
  1452.           -- mandatory for all resolver software implementations.
  1453.  
  1454.           dnsResStatGoodCaches OBJECT-TYPE
  1455.                SYNTAX  Counter
  1456.                ACCESS  read-only
  1457.                STATUS  mandatory
  1458.                DESCRIPTION
  1459.                        "Number of RRs the resolver has cached successfully."
  1460.                ::= { dnsResStats 1 }
  1461.  
  1462.           dnsResStatBadCaches OBJECT-TYPE
  1463.                SYNTAX  Counter
  1464.                ACCESS  read-only
  1465.                STATUS  mandatory
  1466.                DESCRIPTION
  1467.                        "Number of RRs the resolver has refused to cache
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.           Expires December 10,1993                             [Page 25]
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.           draft                  DNS Resolver MIB                June 93
  1480.  
  1481.  
  1482.                         because they appear to be dangerous or irrelevant.
  1483.                         E.g., RRs with suspiciously high TTLs, unsolicited root
  1484.                         information, or that just don't appear to be relevant
  1485.                         to the question the resolver asked."
  1486.                ::= { dnsResStats 2 }
  1487.  
  1488.           dnsResStatGoodNCaches OBJECT-TYPE
  1489.                SYNTAX  Counter
  1490.                ACCESS  read-only
  1491.                STATUS  mandatory
  1492.                DESCRIPTION
  1493.                        "Number of authoritative errors the resolver has cached
  1494.                         successfully."
  1495.                ::= { dnsResStats 3 }
  1496.  
  1497.           dnsResStatBadNCaches OBJECT-TYPE
  1498.                SYNTAX  Counter
  1499.                ACCESS  read-only
  1500.                STATUS  mandatory
  1501.                DESCRIPTION
  1502.                        "Number of authoritative errors the resolver would
  1503.                         have liked to cache but was unable to because the
  1504.                         appropriate SOA RR was not supplied or looked
  1505.                         suspicious."
  1506.                ::= { dnsResStats 4 }
  1507.  
  1508.           -- Lame Delegation Table
  1509.  
  1510.           -- A lame delegation occurs when a parent zone delagates authority for a
  1511.           -- child zone to a server that appears not to think that it is
  1512.           -- authoritative for the child zone in question.
  1513.  
  1514.           dnsResLameDelegationTable OBJECT-TYPE
  1515.                SYNTAX  SEQUENCE OF DnsResLameDelegationEntry
  1516.                ACCESS  not-accessible
  1517.                STATUS  mandatory
  1518.                DESCRIPTION
  1519.                       "Table of name servers returning lame delegations."
  1520.                ::= { dnsResStats 5 }
  1521.  
  1522.           dnsResLameDelegationEntry OBJECT-TYPE
  1523.                SYNTAX  DnsResLameDelegationEntry
  1524.                ACCESS  not-accessible
  1525.                STATUS  mandatory
  1526.                DESCRIPTION
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.           Expires December 10,1993                             [Page 26]
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.           draft                  DNS Resolver MIB                June 93
  1539.  
  1540.  
  1541.                    "Entry in lame delegation table."
  1542.                INDEX { dnsResLameDelegationSource,
  1543.                        dnsResLameDelegationName,
  1544.                        dnsResLameDelegationClass }
  1545.                ::= { dnsResLameDelegationTable 1 }
  1546.  
  1547.           DnsResLameDelegationEntry ::=
  1548.                SEQUENCE {
  1549.                    dnsResLameDelegationSource
  1550.                        IpAddress,
  1551.                    dnsResLameDelegationName
  1552.                        DnsName,
  1553.                    dnsResLameDelegationClass
  1554.                        DnsClass,
  1555.                    dnsResLameDelegationCounts
  1556.                        Counter,
  1557.                    dnsResLameDelegationValid
  1558.                        DnsValid
  1559.                }
  1560.           dnsResLameDelegationSource OBJECT-TYPE
  1561.                SYNTAX  IpAddress
  1562.                ACCESS  read-only
  1563.                STATUS  mandatory
  1564.                DESCRIPTION
  1565.                        "Source of lame delegation."
  1566.                ::= { dnsResLameDelegationEntry 1 }
  1567.  
  1568.           dnsResLameDelegationName OBJECT-TYPE
  1569.                SYNTAX  DnsName
  1570.                ACCESS  read-only
  1571.                STATUS  mandatory
  1572.                DESCRIPTION
  1573.                        "DNS name for which lame delegation was received."
  1574.                ::= { dnsResLameDelegationEntry 2 }
  1575.  
  1576.           dnsResLameDelegationClass OBJECT-TYPE
  1577.                SYNTAX  DnsClass -- INTEGER (0..65535)
  1578.                ACCESS  read-only
  1579.                STATUS  mandatory
  1580.                DESCRIPTION
  1581.                        "DNS class of received lame delegation."
  1582.                ::= { dnsResLameDelegationEntry 3 }
  1583.  
  1584.           dnsResLameDelegationCounts OBJECT-TYPE
  1585.                SYNTAX  Counter
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.           Expires December 10,1993                             [Page 27]
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.           draft                  DNS Resolver MIB                June 93
  1598.  
  1599.  
  1600.                ACCESS  read-only
  1601.                STATUS  mandatory
  1602.                DESCRIPTION
  1603.                        "How many times this lame delegation has been received."
  1604.                ::= { dnsResLameDelegationEntry 4 }
  1605.  
  1606.           dnsResLameDelegationValid OBJECT-TYPE
  1607.                SYNTAX  DnsValid
  1608.                ACCESS  read-write
  1609.                STATUS  mandatory
  1610.                DESCRIPTION
  1611.                       "Set to CLEAR to delete this lame delegation entry."
  1612.                ::= { dnsResLameDelegationEntry 5 }
  1613.  
  1614.           -- Resolver Optional Counters Group
  1615.  
  1616.           -- Implementation of the Resolver Optional counters group is optional.
  1617.  
  1618.           dnsResOptCounterReferals OBJECT-TYPE
  1619.                SYNTAX  Counter
  1620.                ACCESS  read-only
  1621.                STATUS  mandatory
  1622.                DESCRIPTION
  1623.                        "Number of responses which were received from
  1624.                        servers redirecting query to another server."
  1625.                ::= { dnsResOptCounter 1 }
  1626.  
  1627.           dnsResOptCounterRetrans OBJECT-TYPE
  1628.                SYNTAX  Counter
  1629.                ACCESS  read-only
  1630.                STATUS  mandatory
  1631.                DESCRIPTION
  1632.                        "Number requests retransmitted for all reasons."
  1633.                ::= { dnsResOptCounter 2 }
  1634.  
  1635.           dnsResOptCounterNoResponses OBJECT-TYPE
  1636.                SYNTAX  Counter
  1637.                ACCESS  read-only
  1638.                STATUS  mandatory
  1639.                DESCRIPTION
  1640.                        "Number of queries that were retransmitted because of
  1641.                        no response."
  1642.                ::= { dnsResOptCounter 3 }
  1643.  
  1644.           dnsResOptCounterRootRetrans OBJECT-TYPE
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.           Expires December 10,1993                             [Page 28]
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.           draft                  DNS Resolver MIB                June 93
  1657.  
  1658.  
  1659.                SYNTAX  Counter
  1660.                ACCESS  read-only
  1661.                STATUS  mandatory
  1662.                DESCRIPTION
  1663.                        "Number of queries that were retransmitted that were to
  1664.                        root servers."
  1665.                ::= { dnsResOptCounter 4 }
  1666.  
  1667.           dnsResOptCounterInternals OBJECT-TYPE
  1668.                SYNTAX  Counter
  1669.                ACCESS  read-only
  1670.                STATUS  mandatory
  1671.                DESCRIPTION
  1672.                        "Number of requests internally generated by the
  1673.                        resolver."
  1674.                ::= { dnsResOptCounter 5 }
  1675.  
  1676.           dnsResOptCounterInternalTimeOuts OBJECT-TYPE
  1677.                SYNTAX  Counter
  1678.                ACCESS  read-only
  1679.                STATUS  mandatory
  1680.                DESCRIPTION
  1681.                        "Number of requests internally generated which timed
  1682.                        out."
  1683.                ::= { dnsResOptCounter 6 }
  1684.  
  1685.           END
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.           Expires December 10,1993                             [Page 29]
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.           draft                  DNS Resolver MIB                June 93
  1716.  
  1717.  
  1718.           7.  Acknowledgements
  1719.  
  1720.           This document is the result of work undertaken the by DNS
  1721.           working group.  In addition, the contributions and comments of
  1722.           the following members are also specially acknowledged:
  1723.  
  1724.                Philip Almquist, Computer Communication consultant
  1725.  
  1726.                Joe Peck, Digital Equipment Corporation
  1727.  
  1728.                Frank Kastenholz, FTP Software
  1729.  
  1730.                Win Treese, Digital Equipment Corporation
  1731.  
  1732.                Mimi Zohar, IBM
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.           Expires December 10,1993                             [Page 30]
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.           draft                  DNS Resolver MIB                June 93
  1775.  
  1776.  
  1777.           8.  References
  1778.  
  1779.                J. Reynolds and J. Postel, Assigned Numbers. Internet
  1780.                Working Group Request for Comments 1010.  Network
  1781.                Information Center, SRI International, Menlo Park,
  1782.                California, (May, 1987).
  1783.  
  1784.                M. Stahl, Domain Administrators Guide.  Internet Working
  1785.                Group Request for Comments 1032. Network Information
  1786.                Center, SRI International, Menlo Park, California,
  1787.                (November, 1987).
  1788.  
  1789.                M. Lottor, Domain Administrators Operations Guide,
  1790.                Internet Working Group Request for Comments 1033. Network
  1791.                Information Center, SRI International, Menlo Park,
  1792.                California, (November, 1987).
  1793.  
  1794.                P. Mockapetris, Domain Names - Concepts and Facilities,
  1795.                Internet Working Group Request for Comments 1034. Network
  1796.                Information Center, SRI International, Menlo Park,
  1797.                California, (November, 1987).
  1798.  
  1799.                P. Mockapetris, Domain Names - Implementation and
  1800.                Specification, Internet Working Group Request for
  1801.                Comments 1035. Network Information Center, SRI
  1802.                International, Menlo Park, California, (November, 1987).
  1803.  
  1804.                V. Cerf, IAB Recommendations for the Development of
  1805.                Internet Network Management Standards. Internet Working
  1806.                Group Request for Comments 1052. Network Information
  1807.                Center, SRI International, Menlo Park, California,
  1808.                (April, 1988).
  1809.  
  1810.                R. Braden (editor) Requirements for Internet Hosts --
  1811.                Application and Support, Internet Working Group Request
  1812.                for Comments 1123. Network Information Center, SRI
  1813.                International,Menlo Park, California, (October, 1989).
  1814.  
  1815.                M.T. Rose and K. McCloghrie, Structure and Identification
  1816.                of Management Information for TCP/IP-based internets,
  1817.                Internet Working Group Request for Comments 1155. Network
  1818.                Information Center, SRI International, Menlo Park,
  1819.                California, (May, 1990).
  1820.  
  1821.                K. McCloghrie and M.T. Rose, Management Information Base
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.           Expires December 10,1993                             [Page 31]
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.           draft                  DNS Resolver MIB                June 93
  1834.  
  1835.  
  1836.                for Network Management of TCP/IP-based internets,
  1837.                Internet Working Group Request for Comments 1156, Network
  1838.                Information Center, SRI International, Menlo Park,
  1839.                California, (May, 1990).
  1840.  
  1841.                J.D. Case, M.S. Fedor, M.L. Schoffstall, and J.R. Davin,
  1842.                Simple Network Management Protocol, Internet Working
  1843.                Group Request for Comments 1157. Network Information
  1844.                Center, SRI International, Menlo Park, California, (May,
  1845.                1990).
  1846.  
  1847.                M.T. Rose, The Open Book, A Practical Perspective on OSI.
  1848.                Prentice Hall, Englewood Cliffs, New Jersey, (1990).
  1849.  
  1850.                M.T. Rose and K. McCloghrie (editors) Concise MIB
  1851.                Definitions, Internet Working Group Request for Comments
  1852.                1212, Network Information Center, SRI International,
  1853.                Menlo Park, California, (March, 1991).
  1854.  
  1855.                K. McCloghrie and M.T. Rose (editors), Management
  1856.                Information Base for Network Management of TCP/IP-based
  1857.                internets: MIB-II, Internet Working Group Request for
  1858.                Comments 1213. Network Information Center, SRI
  1859.                International, Menlo Park, California, (March, 1991).
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.           Expires December 10,1993                             [Page 32]
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.           draft                  DNS Resolver MIB                June 93
  1893.  
  1894.  
  1895.           9.  Security Considerations
  1896.  
  1897.           Security issues are not discussed in this memo.
  1898.  
  1899.  
  1900.           10.  Author's Addresses
  1901.  
  1902.  
  1903.                Rob Austein
  1904.                Epilogue Technology Corporation
  1905.                268 Main Street, Suite 283
  1906.                North Reading, MA 01864
  1907.                USA
  1908.  
  1909.                Voice: +1 617 942 0915
  1910.                Email: sra@epilogue.com
  1911.  
  1912.  
  1913.                Jon Saperia
  1914.                Digital Equipment Corporation
  1915.                153 Taylor Street
  1916.                M/S TAY2-2/B5
  1917.                Littleton, MA 01460
  1918.  
  1919.                Voice: +1 508-952-3171
  1920.                Email: saperia@tay.dec.com
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.           Expires December 10,1993                             [Page 33]
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.           draft                  DNS Resolver MIB                June 93
  1952.  
  1953.  
  1954.           Table of Contents
  1955.  
  1956.  
  1957.           1 Introduction ..........................................    3
  1958.           2 The Network Management Framework ......................    4
  1959.           2.1 Object Definitions ..................................    4
  1960.           2.2 Format of Definitions ...............................    4
  1961.           3 Overview ..............................................    5
  1962.           4 Selected Objects ......................................    7
  1963.           5 Textual Conventions ...................................    8
  1964.           6 Definitions ...........................................    9
  1965.           7 Acknowledgements ......................................   30
  1966.           8 References ............................................   31
  1967.           9 Security Considerations ...............................   33
  1968.           10 Author's Addresses ...................................   33
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.           Expires December 10,1993                             [Page 34]
  2005.  
  2006.